package com.nidu.demo.user.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.user.model.User;
import com.nidu.demo.user.model.UserCriteria;

import java.util.Set;
import java.util.List;

/**
 * 用户网关接口
 * 提供领域层对用户的访问能力
 *
 * @author auto
 */
public interface UserGateway {

    /**
     * 创建用户
     *
     * @param user 用户信息
     * @return 创建后的用户
     */
    User create(User user);

    /**
     * 更新用户
     *
     * @param user 用户信息
     * @return 更新后的用户
     */
    User update(User user);

    /**
     * 根据ID查询用户
     *
     * @param id 用户ID
     * @return 用户信息
     */
    User getById(Long id);

    /**
     * 根据ID查询用户
     *
     * @param ids 用户ID列表
     * @return 用户信息
     */
    List<User> getByIds(Set<Long> ids);

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户信息
     */
    User getByUsername(String username);

    /**
     * 根据手机号查询用户
     *
     * @param mobile 手机号
     * @return 用户信息
     */
    User getByMobile(String mobile);

    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户信息
     */
    User getByEmail(String email);

    /**
     * 删除用户
     *
     * @param id 用户ID
     */
    void deleteById(Long id);

    /**
     * 批量删除用户
     *
     * @param ids 用户ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 查询用户列表
     *
     * @param criteria 查询条件
     * @return 用户列表
     */
    List<User> listByCondition(UserCriteria criteria);

    /**
     * 分页查询用户
     *
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<User> pageByCondition(UserCriteria criteria);

    /**
     * 更新用户状态
     *
     * @param id 用户ID
     * @param status 状态值
     */
    void updateStatus(Long id, Integer status);

    /**
     * 更新用户密码
     *
     * @param id 用户ID
     * @param password 密码
     */
    void updatePassword(Long id, String password);

    /**
     * 更新登录信息
     * @param userId 用户ID
     * @param loginIp 登录IP
     */
    void updateLoginInfo(Long userId, String loginIp);

    /**
     * 更新个人信息
     * @param userId 用户ID
     * @param nickname 用户昵称
     * @param email 邮箱
     * @param gender 性别
     */
    void updateProfile(Long userId, String nickname, String email, Integer gender);

    /**
     * 更新头像
     * @param userId 用户ID
     * @param avatarUrl 用户头像地址
     */
    void updateAvatar(Long userId, String avatarUrl);

}
